Block chat users
Blocking stops a chat user from joining the Live Chat waiting queue for a set time. Use it for users who are abusive or send spam. A blocked user can still talk to the AI Agent. Only the handoff to a helpdesk agent is blocked.
Druid blocks authenticated users and anonymous users differently.
| Authenticated users | Anonymous users | |
|---|---|---|
| Where the block is stored | The user's Live chat blacklist in the Druid Portal | The current conversation ([[ConversationInfo]]) |
| Who can block | A helpdesk agent through a flow, or a Druid Portal user who manages users | A helpdesk agent through a flow |
| Who can unblock | A Druid Portal user who manages users | A flow |
Let agents block users
Add a blocking path to the Live chat agent disconnected flow, after the agent chooses a resolution.
- Open the
live-chat-agent-disconnectflow. - After the resolution step, add a branch for blocking, for example a choice that the agent selects.
- On that branch, add an Action step. In Post Actions, add the
HelpdeskClient.IsBlockedForLiveChatinternal action with these parameters:Copy{
"BlockIntervalMinutes": 1440,
"BlockReason": "Abusive language",
"SaveToChatActivityData": true
} - Save the flow.
| Parameter | Description | Default |
|---|---|---|
BlockIntervalMinutes
|
How long, in minutes, the user is blocked. | 1440 (24 hours) |
BlockReason
|
Why the user is blocked. | — |
SaveToChatActivityData
|
true saves the block details for authenticated users in [[ChatActivityData]]. |
false
|
Anonymous users are blocked only within the current conversation. Keep their blocking period short, or use the default.
When a blocked user asks for a helpdesk agent, ConnectToHelpdeskAgent returns false in @InternalActionResult. Druid also sets [[HelpdeskClient]].IsBlockedForLiveChat. Handle this in your flow, the same way you handle Working hours and automatic sign-out.
Block data
For authenticated users, when SaveToChatActivityData is true, Druid stores these fields in [[ChatActivityData]]. The same details appear on the user's Live chat blacklist tab.
| Field | Value |
|---|---|
LiveChatBlockedUntil
|
When the block ends: the block time plus BlockIntervalMinutes. |
LiveChatBlockedReason
|
The reason. |
LiveChatBlockedAt
|
When the agent blocked the user. |
LiveChatBlockedByAgentName
|
The email of the agent who blocked the user. |
For anonymous users, Druid stores [[ConversationInfo]].LiveChatBlockedUntil: when the block ends in the current conversation.
Block or unblock an authenticated user in the Druid Portal
- Select Administration > Users. To see only blocked users, select Show only blocked chat users.
- Next to the user, select Actions > Edit.
- Select the Live chat blacklist tab. The tab shows Blocked until, Reason, Blocked by, and Blocked at.
- Do one of the following: - To block the user, enter a Reason, enter the number of minutes next to Block user (default 1440), and then select Block user. - To unblock the user, select Unblock user.
- Select Save.
Unblock an anonymous user from a flow
Anonymous users are blocked in the conversation context, so a flow can unblock them. For example, in a flow step's Set Variables, set [[ConversationInfo]].LiveChatBlockedUntil to null, or set [[ConversationInfo]].LiveChatBlockedUntil to GetDate. When the user reaches that step, the block ends.